Skip to content

feat: add sidecar verify command - #10

Merged
HaoZeke merged 1 commit into
mainfrom
feat/sidecar-verify
Nov 17, 2026
Merged

HaoZeke merged 1 commit into
mainfrom
feat/sidecar-verify

Conversation

@HaoZeke

@HaoZeke HaoZeke commented Nov 17, 2026

Copy link
Copy Markdown
Contributor

Summary

This change adds rfc9162-sidecar verify for offline verification of a signed checkpoint and, optionally, a path's inclusion in that checkpoint.

The command verifies the C2SP signed-note checkpoint in the sidecar pack against one or more trusted key lines (--trusted).

When --path REL_PATH is provided, it opens the log at the signed checkpoint size and root, finds the latest entry for that path, and checks that the entry is included under the same trusted checkpoint root.

Details

  • Adds a new verify subcommand to rfc9162-sidecar.
  • Keeps existing behavior opt-in. No existing command behavior changes.
  • Uses the crate's existing checkpoint and inclusion verification code.
  • Preserves exit code behavior:
    • 0 on successful verification.
    • 1 when verification, store reads, or inclusion checks fail.
    • 2 for invalid command line arguments.

Tests

  • Extends sidecar CLI tests with:
    • successful offline checkpoint and inclusion verification,
    • tampered checkpoint note rejection,
    • tampered inclusion source rejection.
  • Runs the full local workflow job set and records outputs in ci-local.log.

Documentation

  • Updates sidecar command reference with verify usage and output.
  • Adds how-to note for offline checkpoint and inclusion verification.

@HaoZeke
HaoZeke merged commit a1f702b into main Nov 17, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant